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Miscellanea 



IBM has launched an assault on the home market Apple has 
long ignored. As Tom Weishaar mentioned in "Personnel moves rock 
Apple" (March 1990), Apple has repeatedly said it believes that there 
^ a business setjmenl and an alucation segment to the personal 
eeiipwter laarkRt^ tiut that thgte M ip distinct home segiKnt, Apple 
bgib*^ tt^ iiBmt wttip&& M out of those ediiiE^tm and 

titfembrith iBWi hew fnod^ ^/l started appearing in stores artd 
reports started appearing In the press. It is hardly state of the art: a 
lOMUz 80286 processor in a system that includes a 1.44 megabyte 
floppy disk, 2400 baud modem and mouse. The basic system is cur- 
rently sold in three configurations; the floppy-based monochrome sys- 
tem ($1000), the same system plus a 30 megabyte hard disk, and a 
color system with hard disk ($2000). In deference to the first-time 
buyer, IBN has left the configuration decisions for the bl@ic system 
simple: deade if you want aiiiand disk icicl decicie If you wiiit a color 
display. Those are the on^ Choices you have to mate. 

The hardware is not Imposing, but the Impllcatton is: Bill Machrnne 
of PC Magazine reports in his August editorial that IBM believes there 
are 66 million households that can afford this type of system, Thai 
kind of potential has apparently dragged IBM salivating into a market- 
ing strategy aimed directly where Apple isn't; presenting systems as 
attractive for a home marKct that is not directly tied to education or 
business. 

Toward that end, IBM has tailored the PS/ 1 to J>e easy to use. You 
bring the system home in one box; the setup manual is packaged 
already opened to the page telling you how to set up the system. You 
attach the monitor, mouse, and keyboard, then run the power cord to 
the wall and the modem phone line to a phone jacK. Then turn it on; 
the system prompts you from there, and help Is always available, One 
of the options the machine automatically gives you is support via the 
Prodigy information service (which will ' be expanded nationally). 
Another is a limited MouseText-llke version of Microsoft Works, which 
is a clone, right down to the name, of AppleWorks. The version bun- 
dled with Hie PS/I includes a word processor, a spreadsheet, a 
database, and t cijmmwileations module. Th^^. make the safstem 
immediately useRd. 

tmi even feapi to get around callous dealers interested 
In moving product but niot helping entry-level customers. The units 
will be sold primarily through 5ears retail outlets; IBM is putting this 
machine in the path of potential customers who would never enter a 
computer store. Rather than depend on dealer salespeople, IBM also 
offers F5/I customers an 800 number available for basic tectmicai 
questions. 

We played with the units at a local Sears outlet; the system design 
prevents the user from ever seeing the Intimidating MS-DOS com- 
matid-line mq«jg by accident (you can get there on purpose if you 
Mt% The spfem itoiio that was ri^ an 
admirable job of presenting athractive features of the system for home 
users; of course, much was made of the fact that IBM was bringing its 
office environment expertise "home"! That IBM logo carries weight 
that will sway customers hesitant to buy an "off brand" MSD05 com- 
patible. 

But the sad thing is that an Apple ligs setting next to the FS/1 



would be very competitive, The animations running on the FS 1 
looked stilted. The sound quality, even with the optional audio card, 
doesn't even get off the ground compared to the Ilgs. The screen has 
an annoying flicRer when svfltching modes. The price is less than a 
ajmpaiable llgs system, but then the Ilgs pricing Is to allow for 
dealer discounting (it's unlikely Sears' pricing structure allows for 
dickering). And the pricing gap is close when you consider the capa- 
bility and expandability built into the llgs that costs extra on the PS/ 1 
(expansion slots, sound capability, and so on), 

■Apple could respond to the competition by bundling AppleWorks or 
AppleWorks 05 (or both) with the llgs, particularly now that Claris is 
back under Apple's total control. Apple could also have used Apple- 
Unk Personal Edition as its on-line support vehicle, though it's too late 
for that now. Apple continues to believe technology alone can cany 
the company; yet seems to self-destruct every opportunity to make it 
patatabRj to the public 

The big disadvantages the Apple llgs has compared to the PS/1 are 
distribution and software availability; both are closely tied to the 
myopic way in which Apple has marketed the Apple II line since the 
introduction of the Mac. Despite the fact that Apple's customers have 
clearly stated their desires and despite a four-year lead time, IBM has 
beat Apple to the market that the llgs is perfect for I hope Apple finds 
the results truly embarrassing. 

Apple has announced a price drop on the Mac lid. Price reduc- 
tions of up to 20 per cent were announced for various conffewciions. 
That leaves the least expensive Mac ltd s^m price at $5,969. 

Neanwhile. rumors of the new low cosf Mac systems to be 
introduced in October seem to be converging on three models. 
The Mac Classic will be a replacement for the Mac Plus and Mac 5E 
coming in at about $ i ,600 retail. The Mac LC will be a 68020-based 
systein that accepts a color monitor and a future Apple 11 emulator 
card. And the Mac llsi will be a 68030-based 16 MHz color systern 
predicted to come in at about $2800, We'll see for sure in October. 

nds tias bem the mcntth of llgs teasers. Coming on the heels 
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of demonstrations at the A2-Centra/ Summer Conference, we have 
seen several new programs written by a nucleus of true ligs gurus, In 
many cases the programs are "laiCiftonstructiori", but show ttat (Jil 
llgs is as {or more) powerful than many of us have believed. 

First to be seen was Wodu/ae, a demonstration of three dimension- 
ai animation from the FTA (Free Tools Association), a gipup.ot 11^ 
Rackers based in Dijon, France. TTA accrued fame via their previous 
Fiackus and 'Space Marrier" demos as well as tfie shareware disk util- 
ity, Photonix. Like their earlier productions (and somewhat to our ciia- 
grin), Modutae eschews use of the llgs toolbox to the point where it is 
incompatible with QS/OS; it must be booted from its own dish and 
requires booting the system again to return to QS/OS. On the positive 
side, both the ROM 1 and ROM 03 llgs versions are supported. 

Modu/ae cycles through an introductory screen and demonstrations 
of star field effects, wire frame 0j>jficts, objects composed of splieres, 
star flight effects, and use of the llgs graphics Hlf mode' to draw 
solid objects and, in calculated animations. In the final sequence, yo-ur 
vantage point fs froih the perspective of flying through a maze with 
colored walls,- suddenly you are teleported outside the "maze" to dis- 
cover that you are flying around and through the n"A logo, which 
draws back and presents itself in a horizontal roll. Catchy music is 
flowing from the llgs during all of the demos, and (by turning off the 
"automatic" display mode) y<ju afe allowed 16 pjgy With tft# FOtatiO'ti: 
and sizing of the objects. 



Two other stiiking demos are from a new company still look- 
ing for financing called Dreamworld. (Contact Jason Anderson at 
3l!^^554-?S59.) The first shows DreamQraphics, a QS/05 paint pro- 
gram. The second demonstration. Dream V/sjon, is not OS/OS based 
and boots from its own disk. Both of these are only demos currently. 

DmmiGraphics is desiped to create 16. i56, or 3200 color 
images. The '256-color (with some placement restrictions! mode is 
possible in the llgs's 520x200 Super High Resolution graphics by 
using "dithering," a technique in which colors are mixed within a pat- 
tern to give the impression that the pattern represents a conglomera- 
tion of the two colors. Dithering is analogous to the use of small, 
closely placed colored dots to generate color newspaper photographs. 

The simultaneous display of 3200 color images is possible in the 
llgs, but it isn't easy. The llgs SHR display includes a series of 16 
paiette values that define available colors, and screef! contiol byt^s 
that determine which of these palette values are used for each of the 
200 lines of the display screen. By doing some carefully timed fancy 
footworit as the llgs video hardware draws the display screen to your 
monitor, the 1 6 palette values can be changed as the screen is being 
drawn so that each line can have a distinct palette, 200 lines times 16 
colors (with palette iSwitchjng) available for each line gives pofl avail- 
able colors, 

However changing the palettes "on the fly" like this consumes 
almost all of the llgs's processor time just to display the picture; 




The llgs promise 

The latest issue of AS-CentraJ prompted me 
to write and add my tiil of confusion to the 
Il§S/i*Iac controversy. 1 am an engineering man- 
ager for a large aerospace corporation and nat- 
mally we depend heavily on computere, ranging 
from mainframes to "personal computers". 
Over the past four years Macs have been creej> 
ing Into the engineering organization,; due piaitly 
to my urging and example, 

1 have had an Apple 11 since about 1980 
which I use to provide home analysis and inde- 
pendent review of the work provided by my 
engineers, for engineering applications, I need 
the ability to handle large arrays of data, and a 
good math package. 1 have been "making do" 
with Applesoft by virt;ue of the various compil- 
ers which have slowly come on the market. My 
ntaghUS Opus Stfas to grade perfor- 

mance program aggregating 40,000 lines of 
Applesoft in eight separate but related pror 
granffit One of which had 198 variables*: 

Last year when the time came lo replace my 
trosty Apple lie, I carefully considered the Macs 
IWliich I could purchase through the company 
for a significant discount), the I!gs, and those 
''iblue" things. I finally bought a llgs for one rea- 
son and otie promise. 

The iieason Ts that I like the T/meOuf 
enhanced AppleWorks word processor better 
than any word processor that I have used. 



including those on the Hac It does not have Si 
of the bells and whistles but It does about 90% 
of the things I want to do, 

The promise was that of ORCA/C. I have 
been looking for a good compiled language for 
the lle/ligs family and this seemed to be it. I 
therefore elected to purchase a llgs and soup it 
up with a hard drive, a. rra/isWarp/iQS Gard,.and 
a lot of memory. 

Just as I had made the decision to purchase 
the llgs Apple announced System 5.0, so ( was 
able to wait a -week and buy one of the new 
models. I now find that I have the best of both 
the text-based and graphics-based worlds. 1 use 
the text-based approach for word processing 
and technical programming. I use the graphical 
interface for desktop publishing. 1 nearly have 
my dream machine. 

The mc additional capability that I wowJd 
like to have-on the ilgs system is a good techni- 
cal plotting program. Qraph-it! and TimeOut 
Oraph won't hack it. A not-widely distributed 
DOS 3.3 program called Scientific Plotting 
FacKage by CMl-Cascade comes close but the 
company is out of business and the pacK^e is 
no longer supported. The only other contender 
is the plotting capability of SuperCalc 3a, but it 
is somewhat cumbersome to use, and needs a 
patch which I don't have to make it work on the 
llgs, 1 look with longing at KaleidaQraph and 
DeltaGraph on the Mac and wish that we had 
approximately the same capability on the II 
family. 

now in your previous issue you mentioned 
that someone demonstrated a 640x400 pixel 
screen at the Al-Central Summer Confer- 
eace. How do we get the message out to Apple 
that this is needed!? This Mac-like display capa- 
bility should be the impetus for some good pror^ 
grammer to do the plotting padkgQcs 1 have 
beenneedingt 

'Hother subject. I would like lo send kudos 
to Mike Westenield and his group of Byte Work- 
ers for the continuing development of ORCA/& 
I have been treated most courteously when ) 
bring up what I consider a .iwoblem to them in 
spite of being an amateur when it comes loC, 
The new version 1.1 release of ORCA/Q is a 
vast improvement over the past one. 



And speaking of kudos, A2-Cenb^ deservSs 
one in my book. I always look forward to the 
amval of the monthly issues. Please keep up 
the good work. 

Sidney A, Powers 
Valencia, Calif. 

The problem with Apple's repressive Apple 
n Ttiarheting "strategy" is that they have forced 
most Apple II sotlware companies to market,. 
almost fifltiMy toward educational institutions. 
For many conjpanies, this is the only venue- 
tbey advertise in. Educational companies such 
as Scholastic <to almost all of their safes 
direct mmh thd is, many of their products m 
nc^ soid through national marketing agencies 
and may not show up "on the rack" at your 
local software store. Those with specialized 
needs like yourself should wander through a 
directory tike the IWIW Infonnation Diiect<t 
ry to check into possible software sources. 

Meanwhile, we can supply you a copy of the 
SuperCalc patcfi to allow it to print on an 
ImageWriter from the llgs.—BJfi: 

More SuperCalc memory 

If anyone has a patch to allow SuperCa/c 3a 
to recognize additional memory in the llgs, it 
would help me very much, SuperCalc 3a recog- 
nizes up K> 5 12K on an Apple lie auxiliary slot 
manory expaiBlon card, but won't recognize 
my Dgs memory expansion card, 

Paul X Ho^n 
San Dicgoj Calif, 

This is one that wt don't have an mswerfor 
currently.— DJD 

ProDOS 8 bad blocks 

Will FroDOS 8 write information on bad 
blocks of a hard disk drive? I am concerned 
about a program writing information to a bad 
block and losing important information. 

Douglas Bailor 
Spokane, Wash, 

JJie occurrence of a bad block and its affect 
on your Hie contents is timing<riiical, from the 
time FroDOS has decided which blocH it is 
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some of that time has to be stolen back to allow your paint program 
to function. It apiHiars from the demonstration shots in fte Jliiif* 
Grap/iics deimo that the progrEBn compromises by letting you £^ and 
modify a subset ;a honzontal band) of fhe image in 3200 mode, 
allowing you to graduaily work your way throufiti the entire image. K% 
a reasonable solution, and we frope the 3200 color image format and 
display techniques can be standardized (so far^ not all images and di^ 
play utilities are compatible). 

DreamVlsion is more mysterious. Ttie demo boots into a screen 
simulation of a video monitor and what appears to be a video editing 
GonlroUer (a device to allow you to cut, paste, and copy video 
sequences). "Hie monitor then erupts into a brief Siegfience of a video 
rem^l^WM. daiicer wiOi wffii syttGhfoMlzed soitffd; tte cffed is 
spectacular, as if the Ilgs had become a digital video tape recorder. 
Then an information screen is presented announcing that DreamVJ- 
slon is coming, and the demonstration loops. Some people like to say 
the Apple 11 is "ten year old technology"; put this demo next to 1980'5 
AppkVis'm, with its stick^man dancing to a simple lune on a simulat- 
ed TV screen, and you'll see what a difference ten years has made. 

The last demonstration can also be launched from Q5/()5; it's 
called OS Experience and displays a veiy Impressive three-dimension- 
al rotating °Z" that author Tim Meekins created ("rendered") using a 
superminicomputer and then hansfenred to the llgs. The object 
appe^s to leap out of the screen at you, €ven reproducing the 



Changes in reflected light that were recorded during its creation. 

American Printing House for the Stntf mas announced a Ilgs 
leeision of TEXIMKEB, Ttie. Ilgs version can run in the back^ound, 
pief rHlttlrig tiS* 'S'ith "fiiendly* copy-protected prograaif #lsitl as 
many non-copy protected programs such as AppleWorks* Copy II Bus, 
and the Apple System Utilities. 

The program installs as a ProDOS 8 application, but can remain 
system resident to work with other operating systems such as DOS 
3.3 and Q5/05 text applications. It requires a Ilgs with at least 512K 
bytes of Km, a 3.5 drive, and an Echo (or DoubleTalk, in Echo 
mode) speech synthesizer. The cost is $34.50 {cataios number D- 
89571-00), 

Vle0^m&i ffitfs tidbit [fom tte ^i^eicf Dot liemMerlrm Raised 
DotGoniputing, 4085, Baldwin, l^ladison. Wise. 53703, 608-257-9595 
of FAX 608-241-2498, a newsletter covering microcomputer products 
for the visually impaired. Subscriptions are $18/year in large print, or 
$20' per year on audio tape (add $20/year air mail outside liorth 
America). 

Checknate has resurfaced under a new name: micro Memory. 

The new address is 7655 East Qelding, #61, Scottsdale, Ariz. 85260, 
602-998-0227. Former Checkmate president. Earl Worth is still presi- 
dent 



C|o;ng to write to untH tile data l$ m:tmlly Witt- 
ten to the disk. 

Before FroDOS can write a b/ocA to ttie disk, 
it tias In locate ttie block. It does this by read- 
ing the bioi k /leader (an "address " on ttie disk 
that identifies the block) as it moves the disk 
drive read/write head over the disk. If the 
header is unreadable and can't be found, Pro- 
DOS wilt report an error 

Once ProDOS has found the header, it ales 
to write the block. Looking at the code that 
does this for a 5.25 drive, it dqesn't appear 
that &te ibm$ ys^Hfis ti^ the <Ma ^/m ^tua/- 
fyjet^n^i^WseBsk. However, assuming ^ 
Om tifsk M- j^fl preWousfy formatted ^ 
the headerimsfS^imU^ t*te oMimv^ 
good that rte kMste. 

FroDCS n^fte^ ^ every block in the 
m ft Us yiSim. if no unmanaseable 

e/rois occur, your File is an the disk intact tf 
not, PmDOS will return an error and your pro- 
gram should warn yasi that the ffle was not 
saved. 

however, that does not mean that the file 
will necessarily be intact the next time you 
read the disk. Magnetic fields or physical dam 
age to the disk, among other things, can cause 
the data to fade. There may simply be a 'weak 
spot" in the disk's magnetic coating: not weak 
enough to cause the write to fail, but loo weak 
So retain the data written there between uses. 

You can lessen the chances of some of 
these i>roblems by keeping the disks away 
from l)a/ardous environments, and (for flop- 
pies) by nolidng which brands of disks seem 
to be the most re^Ie far you and st/cA/rg to 
that brand where possible. This won't remove 
almtiiidy 100% of the risk (there's always the 
small chance that the disk will decide bo forget 
what it knows immediately after you write to 
ftj, tmtym can get pretty darn c/bse. 

CXtm than t/iat the only way to make sure 
you don't lose data is to make sure you have a 
badsup of every fife you confer to be Impor- 
tant it yen to UtBow that simple nil& 
Oiete & no tSak recovery program^ i^vm 
detector, or oOier utility on fbe tnarieet 
that can Jielpyau. Period.— DJD 



Wrong numfaer 

I tm/e proBkm hi iie new JkiDGS B 

vl.9 in conjiinctton with OS/OS 5-0.2. I 
renamed the PRODOS file to *P8* and copied it 
into the System folder. Whai I then launched a 
ProDOS 8 application with my ProSel selector, I 
got the message "incorrect ProDOS version". 
Can vou help, or is the new FioOOS not com- 
patible with QS/OS 5.0,2? 

Gunther Unqer 
Emmerich, West tiermany 
There seems to be confusion in the concept 
of Ilgs System Software, OS/OS, and ProDOS S. 

The ttigs ^stem Software is the entJ^ par- 
age of OS/OS, ftiaDOS 8. tfie toofe drivers, 
and so on. The most recent version of this Is 
5.0.2. 

QS/OS is &ie ieM native operating system 
of the Ilgs. GS/OS itself Is resp(msible for com- 
municating with devices while the ilgs is in 
native (16-bit) mode and for managing the rest 
of the components of the S}'Stem software 
(loading tools, for example). The version of 
05/05 supplied with 5.0.2 is version .5, but 
there are several minor components all with 
their own version numtiers. For example, in 
the change from Sy.s/er?] Software 5.0 to 5,0.2 
the version number of the supplied ProDOS 

r changed from 3.0 to 5.01. 

ProDOS 8 is responsible for communicating 
with disk devices from the B-bit "lie emulation" 
mode of the ligs. ProfX)S 8 is also a compo- 
nent ot GS/OS; 05/OS launches ProDOS 8 in 
order to run an 8-bit program. It is here that 
(be version number of the ProDOS 8 'Pd' file 
comes to matter to 05/05; it needs to check 
the version number to verify that a version-spe- 
cific patch can be made to F8's quit code so 
that it can return control to QS/CS . If you 
change the version ofF8. it^ao ior^r recog- 
nized » tfie 'correcr versfon by GS/OS^ 

rve ^tmys reeommeBded irstng tl^ i^dest 
version of tfic sj^&n software for your system 
(barring contrary advice from Apple, which has 
haj^ien&l only rarely in the last few years). I 
shotudd now clarify that in saying 'system soft- 
ware' I am referring to t/ie camptete system 
^mne enviriinment; /tidfWdua/ corapaheMs 



shouldn't be itadifteid mtiioiA Mf^k's recom- 
mendation. 

in other words. Ilgs 5>s(em Software 5.0.2 is 
the current release version for the Ilgs, and 
you shouldn't modify any component Files 
except per approved updates. This can be a 
modification to the operating system as 
released by Apple (the Apple High-Speed SCSI 
card comes with a minor revision to the Ilgs 
system software used to support new features 
of the card) or a driver supplied by a third 
party in accordance with j^ie's documented 
methods of enhandng the system software. 
fioweverJ chan^g files aib^rily (even mth 
Apple's own may not mrk io your advan- 

The new ProDOS 8 system dkk woffe Sne 
by itself. But don't use It to 'update' the Ilgs 
System Software; Apple lias been releasmg 
those updates independently.^XID 

Giving it tlie boot 

I have an Apple Ilgs, I would like to know 
how to configure a program dish so that, when 
ran, it will bypass the Finder. I am trying to run 
an application from the desktop, hui 1 would 
also like to know how to do this ifrom the 
beginning). 

I have at least two applications that I launch 
from the desktop. To get there, I must use my 
system disk. Immediately after arriving at the 
desktop, I remove the system disk and insert, 
say, PaintWorks Plus. I then double-click on the 
PainlWorks Plus application icon and the pro- 
gran loads. During this process, I am continual- 
ly^cd to swap dfefe fem the %stiem dis^ to 
the FaintWorks i^us otta I kndw that I have only 
one drive, but I would file to know why all this 
swapping Is necessaiy aiid tf itee is # w% 
moid it? 

^hn Qu^enheini 
Bryn Mawr, Penn. 

There is no real magic to avoiding <Ssk 
swaps. Unless the opcrah'ng system software 
(05/05J and the program itself will fit into the 
800K of disk space on cunent i(gs 5.5 drives, 
you must swap tOsks once or twice whSe 
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startins a OS/OS application on a sin^e-drive 
system. The //gs is not unique in ttiis; both the 
Mac and MS-DOS machines are in a similar 



To see if the program might fit on a single 
disk. If}' the following. Make a copy of your 
usual startup dish, and use Ihe Ilgs Installer 
ion the /System.Toals d/.sh- (o configure the 
disk M/ilh the minimum features you need to 
run ihe program at issue. There are no hard 
rules as lo what items may not be needed, but 
common sense should dictate some: for exam- 
ple, a game that doesn t allow you to access 
the printer should indicate thai you won't need 
a printer installed. When you've stripped every- 
thing that you know fsn'f needed, boot your 
new startup disk. 

How insert the disk with your program fOe 
dad launch the pto^m, rinder will 'unload' 
is^ attd twmk ^ new program. The pro- 
§im mqske^om ci tbe Ites too^ that 
are not mnemyla mmoty, reqamas Ute &st 
swap back to tfte system startup Tlm ih0 
progmm may have arS^oit^ por&mts stmV^ 
to joait, regi&its ^ sw^baEKl9\l^j^m^ 
(Ush. tn most cases^ iMse titv swaps smi^ 
be adequate to get the program go/ng. 

// the program does launch and run, it /ndf- 
cates that the program may not require files to 
be added to the System folder of your startup 
disk, which qrealty simplifies the detective 
work in Cmding out what files need to be 
added to your startup disk. Quit the program 
(more disk swaps) and boot your normal start- 
up dish. 

Insert your program dish and make note of 
the files thai appear in the root (volume) direc- 
tory of the disk that do not appear to be 
among the riles found in the directory of toe 
startup disk you created to use with that pro- 
gram (PRODOS. BASIC. Launcher, BA^CSys- 
tem. System, AppleTalk, and Icons). 

Iiaert the new startup (flsft you've made for 
yoiff program and. un/ess Oi^ g^pear m Oie 
pragim (UsK drag t^^m^^S^ mi 
B^tClwncher into Ute tia^ Hetw uipen Uie 
Sy^em/ folder aid drag the ftte named STMT 
(which is actually ^nSai Aito ttK tr&^ can. 
Empty the trash, and note tww much Biee disk 
space you have left. Eject the startup disk 
(don't drag it into the trash; use open-api^e-E 
or the drive's eject button so that the dimtw^ 
image of the disk remains on ihe desktop. 

Insert the program disk select the files and 
folders that don't appear on your startup dish. 
To determine whether the files Mil fit, you can 
use the "Icon Info" item of the Finder's "Spe- 
cial" menu (for folders, the "Calculator' icon in 
the info box will sum the sizes of the files the 
folder contains). If there appears to be enough 
space, drag them onto the dimmed startup 
disk image. Follow the commands to swap 
disks until Finder has copied the program disk 
files onto the new startup dish. 

liow check the startup disk to see if the pro 
gran file's name ends In '.5V5/6'. !f act, 
you'S need to reimnie it; for example, jou may 
£at« to r&isme the file 'MyFrc^am' to 
f^tog^iB'. Once the fife is cwMmeit fry 
booting the startup (ML t vM woOt. or 

If ft doesi't twwft, and ^ lecefwed * *Vot- 
ume full" error message during the (X0, lien 
there isn't enough mom on the BOOK disk for 
OS/OS and Ihe program. All you can try to do 
is remove files you believe the program 
doesn't need. Once you've removed as many 



elements as you can manage with installer, 
you can try deleting other "flexible' compo- 
nents of the startup disk's system software, 
tiere are the minimum file requirements need- 
ed to boot system software version 5.0.2 (ref- 
erence: Apple I! G5 05 Technical note #/; 
Contents of System. Disk and System. Tools): 

ficoos 



requind f« Iffi* 3,5 Mm 



Kqiimi iot Control fuel HA 

KH 01 tool setup 
BUSS tea «^ 



nqiiind for FeoDOS B 
mjuiied for J^l«Soft basic 
nqiiutd by rinder for ifipleSoft 

Comments indicate special considerations. 

Italicized items should be included unless 
in feasible, tierc are some further comments. 

The Control fanel HDA program is contained 
in the CtlFanel.nDA file and uses the CDev 
(Control Panel Devices^ files as data; CDev.iri.IT 
loads the CDevs during boot initialization. If 
CDev.lHIT is included the CDEVs folder must 
be present. If you plan to delete the Control 
Panel ,>D1 latid consider thai this is the only 
way to select certain functions of the system; 
the Alphabet, printer, and .'Ipp/f S^urc selec- 
tion prrXocols are not available in the Control 
Panel CDA) you should delete CDev.im, tfte 
CDevs folder and the CtiFanel.tiDA. If you are 
running a program that does not present you 
with an Apple menu where you can access the 
Control Panel tIDA, these files are expendable. 

ExpressLoad ls a system utility that makes it 
possOiii to load RIes la a special (xrr^ible 
tdmiat anidt fa^& that BtarraSty; It should be 
reisiaed Ifat^ possible. Wltlmt it, the fries 
wSl sW Iaad. but more skmfy, 

The use fUes within the Fonts and roots 
folders afc detemjined by the program. The 
test rule of thumb is to see whether the pro- 
gram you are tis/ng comes on a tvotable disk' 
if so, open these folders on the program disk 
and see what files m- present. Leave those 
files in place in the corresponding folders on 
your startup disk. faslFont is a special form of 
the default system font iShaston 8) that allows 
faster drawing of the font on screen; it should 
be retained if possible even if your program 
disk s fonts folder is empty. 

The remaining folders of interest are 
DeskAccs, and System.Setup. If you've started 
with your "mininaHzed' startup disk, the con- 
tents of these fdkiers should approximc^e tfte 
mbdimum configuration su^ested above. 



Apple's tech note does not recommend it for 

disks developers are preparing (which need to 
be compatible with expected system configura- 
tions), but if you are creating a disk that will be 
booted only on your system you can omit the 
tool setup file not specific to your Ilgs ROM 
version. Specifically, if you are a ROM 01 Ilgs 
user you can delete 75 J; for a ROM 03 //gs you 
can delete TS2. Once you have done this, the 
dish win not boot on the "oWfef system. 

These are all stopgap mcisures' at some 
Ume; t/?e llgs'S 65816 can theoretically 
address 16 megabytes as easily as tltc 6502 in 
earlier Apple 11 models can address 64ft (the 
jigs is restricted to using less than 16 
megabytes of HAM by system design ccffl- 
straints). Just as Apfie II programs such as 
AppleWorks and Pascai outgrew a s/ngte i40K 
5.25 disk, 1^ programs are fast outgrowing 
the use of a sln^e 3,5 disk. The solution is to 
add niove (Mm, espe^ly a h^nm^xify 
6Sse siKb m a Imt 1^ Ste ctHeent crop 
of 16^ imd k^gai masMnes from aS m$m- 
facbtttts a Aanf d^k Is fiecom/ng a near 
-DJD 



Posfscr/pf downloads 

I am able to create a PostSaipt file from 
Fublish-ltl 3-0 and get it over to a Mac with a 
LaserWriter riT to successfutly print text and 
Publish-lt! line art. However I get a PostScript 
error when the PostScript cotitains any graphic 
im^es, 

Also, ttie printouts are such ttiat 1 can't get 
anything to print In an area one-tialf inch from 
each paper edge. Is this a limitation in the 
LaserWriter printer or do [ have to do something 
extraordinary? 

Michael Qooding 
Chesterfield, Mo. 

We talked to fUHMNU gum Bruce liosen- 
bium and he clarified some of the "features' td 
the FoatSciipt file generation. 

Most programs that print via 'FoatSalfit^ 
actually download a FostSaipt program 
called LaserPrep that contains subroutines 
{written in PostScript) for common opera- 
tions. For example, there Is no inherent 
PostScript command to draw a rectangle on 
the \irtual page, but a subroutine named "re" 
contained In the LaserPrep file will draw the 
figure. When the computer wants to draw a 
rectangle as part of the printer output, it can 
then use ihe Yc" command. 

One problem that can crop up is trying to 
Install incompatible versions of LaserPrep. 
Fattish'ltl 3.0 ships with a version of Laser- 
Prep that is compatible with the version used 
by the ligs System Software 5.0 and Mac Sys- 
tem Software 6.0. IWien creatmg your 
jViieSci^ (kKimeat in ftatttisMtf 3-0 i>y 
priniBf io a dMk elect to inetiide laser- 

WimtKis m been MManf 0at M, m me 
else has printed to t ^Aice the la^tWl^ ^ 
powered up), and drmt Mditdif ias^f^p 
when you are going to be denmfoadftig Ibe Sk 
to a LaserWriter that has been Initialized. 

If you are going to print a file to the Laser- 
Writer via downloading, make sure you have at 
least one-half inch borders; the PostScript 
output won't support printing clever to the 
er^ of the page than that (&e 'taiger Fiba 
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Area' command in the ^Uc's Page Setup won't 
result in a lai-ger print area for your 'Preformat- 
ted' document file/. The absolute limit is 
about one-quarter inch in any case. If your 
original document is formaUed for an 
ImaQeWriler, you may find the page width 
defined at 8 (rather than 8.5} inches with one- 
quarter inch borders; to prepare the page for 
the LaserWriter, widen Ok mdtti to 8.5 
inches and centei' tbe prfttf ssea tiM'm am- 
hiif Inch Ixx^is. 

You shmM be aware thM EPS (EitcapsiM&l 
PO^Sa^ fflesm tMemt Um ^ <fcant- 

can't {Hint alBeto <Msk mi Wen Impat it as 
an EPS file. 

Another problem you may run Into at a ser- 
vice bureau is in getting them to handle an 
Apple II disk when alt they have is Macintosh- 
es. That's relatively easy; just be sure to bring 
your PostScript file on an 5.5 froDOS dish 
and ask for a Mac that has Apple rile LKhange 
installed. You can use Apple File lixchange to 
imfKirl the file from the f^oDOS disk to the 
"/ac vva [he text translation option. 

All that having been said, we ha\ e run into 
seme instances where a Fublish-lt! file con- 
taining an aUR graphic would generate a 
PostScript rile that the LaserK/'riler gagged on, 
We've sent an example to TlmeVi/orks to look 

Yummy? Ackkt 

Ny daughter ssys the gum oil tj^ epelope 
should be apple Havored. 

JerryQlaccal 
Canton, MA 

Given the typical response we've gotten to 
the "yummy' glue, if you made her lick the 
envelope we're suipri»d she's 5fffl sp&king 

toyou.—DJD 

Gliding mouse 

Having to clean my mouse's ball once a 
week is a real pain. Do you folks Know of any- 
one that makes an ADB compatible optical 
mouse that wralts ieUat% for the ^ple llgs? 

Fia- anyooe han^ag Que saniig pebtem, I 
Rod tbe best to fttsYtkti a diHy ball to do 
thefdlowtng: 

1.. Open the mouse, lemove the b^ and 
deal it with alcohol, per the user's immi 
inactions, 

2. Clean your mouse pad with alcohol 

3. Pour a small amount of alcohol on your 
mouse pad and play your favorite arcade-style 
game for about 1 5-20 minutes, 

4. Wipe any excess alcohol from your mouse 
pad ancl moiisfi. 

This may sound strange, but It works fairly 
well. 

for the faint at heart, fear not; you won't get 
shocked or ruin your mouse doing this, Alcohol 
and Freon are commonly used to clean elec- 
tronic eqid|Hnetit 

Bill Materse 
San Jose, Calif. 

A ifgs itasfon of tte A+ Mouse is k^m 
antmOssd xvmi msil-ortkr ampm^. 
fts Cte 01^ ApfSe II optical motise we koctw 

Mixed-up backup 

Enclosed is a bulletin put out by Applied 
Ingenuity that says that the Backup ii program (I 
believe vl.i) will not handle a hard drive with 



Q5/0S 5.0 or higher 

Also enclosed is an article from the llgs Buy- 
ers Ou/de about the Apple 11 High-Speed SCSI 
Card that says that a new version of Backup il 
(and this Is \2.0i handle 5.0 and higher. 

However, I he manual for the new High-Speed 
SCSI Card slates that the utilities thereon, one 
of which is the new Backup U, iM act woili on 
eariier SCSI cards. 

As the possessor of an older hpfie H SCSI 
card purchased last March, this leaves me up a 
tree. What backup program can be used with 
«arlkiT SCSI cards arid System 5.0.2? Several 
programs are In my colledion such as Ea^ 
Drive and ft-oSd, but which are suitable? Bo^ 
Apple expect one to purchase anothel' SCSI 
card every time they bring out a new operating 
system? 

Incidentally, the documentation for David 
Hill s new version 3.0.2 of JumpStart says that 
the copy program included can correct^ copy 
QS/OS files with any resource forks. 

Robert Allison 
Punta Gorda, Fta. 

Two available incremental QS/OS-based 
backup utilities that will handle System 5.0.2 
"extended' files are Salvatioa Guardian :for- 
meHyJuA SahatUm) (am VJtesse and AnSei- 
i6's £aeKiip f5ee "Esm^t mi^, p. 6.14, 
nmkim), 

M^MXS8utwt^it^amm^&m&- 
^ wit^ ^i^eadetf jflfe$, mttt0nyi0mimm 
report m tnm t^hea ^e^ns wBh Biem (sm 

"mknowtt storage type' error is fea^ble since 
extended files do return a unique storage type 
identifier when the file information is request- 
ed). Utilities that do not work on a nie-by-Tile 
basis can he used; for example, the ProSel-S 
BACIiUF utility that copies the entire used por- 
'tion of a f^olX)S volume biack4^4ihxk fo a 
series of floppies or a file. 

The only 8-bit incremental backup program 
we know of that works with extended Hies is 
Apple's Backup tt v2,0. It is supplied with the 
new High-Speed SCSI card and is also supplied 
as part of the Apple II tligh-Speed SCSI Card 
miilies from AFDA i$50, part f.A02422LL/A; 
currently classiFied as 'l3eta' since it includes 
the beta versions of the Apple Scanner and 
Apple Tape Backup 40SC drivers for the tt^% 
AWiO^ the nmua) cautions agmn^. using 
flpur utflltito on the old cards. Mm 
Oe^h^SSe ^ 013 veMest ^{ AacBup 

ivories with any ProDOS ^ m A^^^} 
volume, regardless of intisifl^e. 

Tim mmual's imning is to prevent users 
from do&s tAfrigs such as using removable- 
media drives (which Oie new dnVm wSI tfo^ 
nizej with the older Rev. C SCSI card, whkh 
doesn't work property with some aspects of 
the new drivers. For example, I can eject and 
swap volumes on a SyQuest drive attached to 
the tligh-Speed SCSI card without problems; 
the Re\. C card becomes confused. Our expe- 
rience is that a warning not to eject a disk with 
the Rev. C card may not be foflowed by a cus- 
tomer, so Apple protMhIy decided not to sup- 
port the use of the new drivers with the older 
card rather than deal with liability issues. 

In fairness, and in response to complaints 
about the new card's price, it is only $129 
including the new software. The Rev, C card is 
not functionally obsolete: the DMA version just 
adds some capabilities, while maintaining the 
same price (You d&i't get to upgrade cars 



when the new model comes out, though it 
would be nice.)~€JD 

BASIC, C? 

I ordered from your organization and 
received the Atldison-Wesley Technical Librao' 
Set. It is most impressive. However, it is for 
someone much more advanced in computer 
techniques than I am. I have owned an Apple II 
Plus, He, and now the llgs, Since the First Apple 
i have tried to team the inner workings and 
tOfiie tiled ia l^ram fon lAy own) machine lan- 
guai^ pogEaiml^|-HUisuccessfu%^ So whim i 
got lie Itbiaiy scl I was rather frusbated to M 
&m tM tejt&OffllSS gave examples on how to 
use the tatt in machine language and C. Is 
there any way that the TooiBox mm 'im 
accessed via BASIC? The Instructions in the Pro- 
grammer's Introduction are rather convoluted 
and make little sease to me. Is ft possible to get 
a translation into simple and understandable 
English of this 'high-level explanation"? I cite 
"Calling from a high levti language" on page 65: 
"The interface libraries that allow C program- 
mers to access the Apple llgs TooIBox are 
included in .APW C. Those libraries contain the 
function definilions for the tool... 
1. Make the routine accessible by using an 
#include statement that indudes the appropii- 
ate file... 

•2, Invoke the call by entering its name and 

su^jing the connect parameters...' 

Etc. that does It mean? Could l ptease get 

some help as to how to access the powerful 

TocSitoxfromB^IC? 

Peter n. Smith 
South Dartmouth, Mass. 

;,ef '5 s(art with the concept of Uie TooIBox 
routines in general, then move on to the lan- 
guage-specific considerations. 

The TooIBox is a library of routines supplied 
by Apple with (he llgs and Mac system soft- 
ware. The specific routines for the two comput- 
ers correlate reasonably well, making some of 
what you learn about the tools on one 
machine useful for prcgramm/ng the other 
The purpose of the TooIBox (for either 
machine) is to provide standardized ways of 
accesMi^ systm Matures. £ach routine is a 
"miJt W Oat pafwm aspeM: fynmm: 
^ymrim^mhmsto^to use fyn motels 
to «t up a Sst <^ Mfom^itton (m i^a ^iue' 
titief ffiat tbe louSse cm use ito pemm its 
fu^lm, and t^ m &^ d&ifexi aMne. 
A? mntf^e of the Tooffiox call Read- 
Aa^J^ie to read the llgs dock is presented 
in "Ttia to took In the to<^box'. pp. 5.21-22, 
Af^ 1987. 

Using these s^danSied routines provides 
two definite bene/Tts. The more you use the 
TooIBox, the more your program is indeperh 
denl of the specific h'ardware features of the 
computer it is running on. This frees Apple 
engineers to make improvements in the com- 
puter hardware without having to worry about 
existing programs 'breahir\g'- By only requiring 
a list of data to be provided to the routine, the 
workings of the routine itself can also be "hid- 
den" from your program, so that the TooIBox 
routines themselies can be improved without 
your program having to be re-written. Occa- 
sionally, ccmpletely tiew routines may be 
ad(k(l th^ a pitgiam can take i^vanta^ of 
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fuse Ap^e Hgs TooOtox Kefereace, Volume 

IJlf Js MI of these), but the important factoris 
that existing programs don't have to (indeed, 
shouldn't, if properly wriltefij. fail to. wark as 
the system is upgraded. 

The third benent also has a darii (well, 
subtly gray) side: by using standardized rou- 
tines, most programs will have a similar "looli 
and fee!'. Programmers should feel encour- 
aged to use the existing tools for the reasons 
in the previous paragraph, and because they 
are there in the system waiting. By encouraging 
programmers to do this, Apple gets the benent 
of making their computers appear easier to 
use by "unifying" the looli of programs that run 
on the system. Sometimes there is too much 
uniformity, which can be a bit taring, so the 
recent upgrades in ligs System Software 5.0.2 
include some new functionality to aiiow pro- 
grammers to design more: 'indepenekiit" ele- 
ments for the user interface. 

That's the ToolBox philosophy. The imple- 
mentation of accessing the ToolBox within a 
specinc language vanes, but basically it eoH- 
^sts of building ttje data structure im the 
ToofBax routine r^ires md ^n c3Hing the 
routine. Some faf^u^es, pite Fas^si md C, 
allow calling a functtm (ot procedure) and 
passing data to the function as it is caileA 
Most BASIC implementations, like Applesoft, 
don't do this and a method of passing the data 
must be contrived. Some extended BASIC 
implementations, like Micol Advanced BASIC, 
do have a function-calling mechanism that 
allows passing data items. In any case, the 
eventual form of the call is broken down into 
machine language and executed. 

The ToolBox manuals present the machine 
language and C forms of the calls because 
these are the high-level languages supported 
by the APW tools. The first line of each defini- 
tion in the manual gives the function number 
and tool set number in the form of a four-byte 
hex word ("$on)3" for function '$0^ of tool set 
"$03") followed by Apple-speciried name for 
the cail CMeadAsciiTime").. A descrif^on of the 
function Mows. Below that is a "FarameteTs" 
section that shows what values sre pa^ed on 
the lIgs stack, and what vMves ate returned. 
Pie.\t is an "Errors ' section tliat imparls what 
error values may be retamed. 

next comes the "C" version of tte caif. The 
C calls are actually converted to a Pascal call- 
ing convention (which is why you continually 
see the declaration of the "C" function as a 
"pascal" call in the ToolBox References). 

ligs high-level languages usually are 
enhanced with some way of executing a 
"generic" ToolBox call, and then a series of 
interface routines are built upon the call. The 
AFW, Merlin, Complete (formerly JML), 
ORCA, and some other languages for the ligs 
include such interfaces as part of the language 
package. 

Let's use ReadASCIlTlme as an example, 
since Tom Welshaar has already described the 
Machine language form (p. 3.22). In C, the 
/dto oftecaJJ IS given as (page 14-14 ofTbe 
Apple Hgs ToolBox Reference. Volume f): 
extem pascal void [!eadASCIITiiiie(buffeiFti) 
pointer bufferPtr; 

The first line defines a C function 
'ReadASCIfTlme" that accepts the data item 
bufferPtr is p&mter to memory that yau have 
reserved to accept the ASCII data} and reti^ns 
nothiT^ ('void" in current C parlance), "extern" 



mtms ffiaf the fhtidfat} h deSti'ed soimwttere 
besides the cuffent C file (the one you're using 
the function in), and "pascal" refers to the fact 
that "bufferPtr" is to be passed to. the TootB&x 
using Pascal, noiC, conventions. 

The second line tells us that "bufferPtr" is a 
variable of type "pointer"; this tells the C com- 
piler how large the data item is so the compiler 
can treat it properly. By knowing the type, the 
compiler can also do some checking for errors 
in our program (for example, if you try to 
assign the pointer value to an Me^r yar^sbie, 
the compiler can warn you). 

Mere's a trfcM pre^j^m iiSiliQ ^adAsclffittie 
in ORCA/C: 

liMoJe <stdis,li> 
linclude <iiii3ctool.li> 

int nainlvoid) [ 

diar Euffer[21] ; /* allocate 21 bytes */ 

pointer Our&iEPtr = a; /' set pointer to buffer •/ 

Sss!teai1iiffi|0n*ifffc):J; /* ^ tinie/dale striflg ♦/ 
|Hft»((3iiiEufPtr); /* and (Jisiplaj it */ 

letm Cr /' retain '*no «tiet* tEfsfcell */ 

1 

For simplicity, this program runs in text mode 
from the ORCA shell; all we're trying to do is 
Imk St M: ise/Med example of one tool call. 

The reason you probably didn't grasp 
"iinclude' is that it doesn't have an equivalent 
in Applesoft. The C compiler includes a prepro- 
cessor that looks for certain patterns in the 
source text and performs certain actions 
before tfie adaa! program tomjsl&Sm. takes 
place, "if include" accepts a Filename and caus- 
es the preprocessor to locate and load the 
named File. If the File is enclosed in "<>" that' 
acters, the preprocessor looks in a specific 
deFined directory; if the name is only enclosed 
in quote marks, the preprocessor looks in the 
current directory. 

"^include <stdio.h>" tells the preprocessor 
to include the contents of the file "stdio.h", 
which contains deFmitions used for standard 
input/output operations (we need this to 
access the display screen), "stdio.h' is a part 
of the standard C language library, and details 
on its use are included in any book on C. 

'^include <misclool.h>" is the llgs-speciflc 
operation that the Programmer's Introduc- 
tion was referring to in item I. The ToolBox 
function ReadAsciiTlme is not inherent to C, so 
we nfeetf to have it defined as a C function 
before we can use it in our C program. That 
definition (similar to the example in the Tool- 
Box Reference) is in the file "misctool.h" that is 
included with both current Apple ligs C compil- 
ers (APIS/ C and ORCA/C). We use 'Saclade' 
to copy that Sk into our program source so 
that we ha\e access to use ReadAsciiTme later 
in our program. 

If you know C, you can figure out the rest; if 
not, there are several good books that can 
help you with the overall program structure 
(among them The C Programming Language 
by Kernighan and Ritchie, and either of two 
books by Mlley and Fohl A Book on C or C 
by Dissection). Our program contains one 
function, main, that creates a buffer for the 
ASCII data returned by ReadAsciiTlme, sets 
OurBufferPtr to the buffer address, and stores 
a null tfyte ('\0' in C parlance) into the last 
byte of the array (C expects strings to be null- 
terminated in most cases). 

I'ie^d we pass OurBufferPtr to the ReadAsci- 



tfime fimtion defined in mIsctooLk TMs cor- 
responds to item 2 of high-level language 
access: ailing the named function with the 
appropriate parametem 

Finally we use the C putsi) function from 
stdio.h to print the string to standard output (in 
this case, the Hgs text screen 'console"), 
"return 0" sends a zero to the ORCA/C shell as 
the error return code; we've defined main as 
returning a value of type, "int" (iiitegerh 
the shell expects. 

This is atxiut as brief an introduction to C as 
i can manage in an attempt to show what the 
Apple ligs ToolBox Reference definitions 
mean. What 1 hope it conveys is how the deFmi- 
tion in the manual translates, into, the syntax of 
a real program. 

now let's try translating ReadAsciiTlme into 
a BASIC dialect, flere's a similar program in 
Micol Advanced S/iiSiiC ferf/re ff§s: 

m Mtttm 

FRX ReadisciiTiiiE[ftiraifPtr] 
JEW = 1ST (OurBufPtr/ (2*161) (get hank into !fi«) 

MSifi = MSB 
LSD -OuraifPtr- [BSfP(2"16)) 
t^-'iitoess idtr ISS) 

mmx 

PROC [mts[(>irBufPtr| 
LocalPtr = Oaaufftr 

REFEXr 
(BE = PEEK(localPtrl 

toalSteslodalPtt tl 
m&tmpt. 

HBPEOC 

toBufPtr = iDDR(Buffet() 

ms OurBii£Ptr+20,0 

GOSDB EeadfisciiTij!£[OuiBu%.r] 

GOSDB futsIOuifiufPtr] 

PSIBT 

END 

Micol BASrc requires that we stari: our pro- 
gram with an identifying name, so we used PrA- 
Time (print ASCII time). We allocate a 21 -byte 
buffer (imaginatively named "Buffer") for the 
ASCII data. Then we define two procedures 
(bracketed by "FEOC" md -mMRfX":)- that 
we'll use later. 

The main program starts by using Micol's 
"APDR" function to return the starting address 
of the array Buffer, assigning it to OurBufPtr, 
and setting the last byte of the array to zero. 
Then we eail tte procedure ReadAsciiTlme, 
pas^ng it ths vaitie of OurBuFPlr. 

^mk BAM! doesn't Made interface files 
for the ToolBox, so we have written our own 
interface function. ReadAsciiTime accepts a 
pointer to a buffer, and we break it into two 
words (two-byte integers) representing the 
bank number md the addr^ ifte may 
within the bank. We pass these to 'the ToolBox 
via Nlcol's TOOLBOX function, which accepts 
the tool number ("3" for the Miscellaneous 
Toolset), tool function number ("15" for 
ReadAsciiTime within the Miscellaneous Tools), 
and (fBllming. a colm) the parmeters (a wprd 
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at a time) in the order that they need to be 
pushed onto the 65816 stack to be passed ta 
the too}, in our ReadAsciiTime call pass 
the pointer as the mast s^fliffcaat • word 
(MSW%} Mowed by the kast st^fkmd word 
(LSW%) of the fouf-t^ OarPointer vMue. ItSs 
here Wat we need to Know haw the ToolBox 
accepts the data in assembly language format; 
that linowledge is required to develop the form 
in which the data needs to fit Mo the TOOL- 
BOX parameter list. 

When ReadAsciiTimeli returns, we call our 
procedure putsO to print the string returned in 
our buffer Via a REPEAT— UHTIL loop, puts!) 
PEEhs success/Ve bytes out of our buffer and 
prints each one, converting the terminating "0" 
value to a carriage return (ASCII 13) and abort- 
ing (the UrfTIL condition fails). 

It gets vety tedious to sit down and write the 
Interfacing code such as our ReadAsciiTime 
example each time you want to use a ToolBox 
function. That's one reason I (personally) pre- 
fer C or Pascal; ym have a high-level language 
that includes the necessary interface files, 
ready. to go. 

A iiik4'p.my company, Codesmith SoftiW^, 
is working m s set of hcoi M3tC pfcx^ufes 
to aid in accessing the i/gs IbofBe*; Hfie 
Codemaster Collection foolBox l&mry, 
Codesmith Software. Codesmith 3ls0 ha$ stcUt- 
ed a laical Adyanced BASIC User Group, 
Membership Dept. #1316, 107 E. fanefte, 
Elmhurst, III. 60126, that shares source code 
and tips with members (this group is not affili- 
ated with MIcol Systems). Itew members 
receive a library disk of ToolBox procedures, 
such as routines to allow using 16 dithered epP 
ors in 640 mode on the ligs StIR screen, 

And if you want to hack at ToolBox access 
from Applesoft, So What Software's CallBox 
[see "QS/OS Resources", pp: feS-g, J^; tmO}: 
includes the tools to do it. 

Some of the data structures used by the lIgs 
ToolBox get quite complex. The other advan- 
tage of C and Pascal is that each language 
allows description of more complex data struc- 
tures than typical BASIC. For example, here's a 
window record .dermition as a C ^ructur^-. 
(include <iriiidDil.iii> 

/i niece FaxaiList stiuctiire is defined */ 
PaiamList Ranotdfin -[ /* new window record */ 



78, 


/* ipaianLangth 




/* vfraaeBits */ 


title,- 


/* vriUe *f 


%. 














1* ifK)rigin,wK)rigijl »/ 




/* )aatafl,)aataH */ 




/* wMaxH,i*Iadf */ 




/* wScrollVer,wScrollHor */ 


%% 


/* *PageVer,)ffageHor */ 


^(^ 


/* wInfoBefCon */ 


Sf 


/• wlnfoHei^t */ 




/* iffraieDefPnjc •/ 




/• wlnfotefProc */ 




/• dCiiiiDeffEOc */ 




/• l*05lU(W »/ 


mi *) -it., 


/• «lsae */ 







t; 

The comments (bracketed by "/'"and "'/"} 
refer to the names of the "Fields" within the 
record RemoteWin as defmed in the C header 
file "window.h". Accessing an Item requires 



that you use a period to separate the 
same of the field from the name of the record, 
so that "RemoleWin.wPlme' 
ffyou p&fer using sirt^e mrays raQier thm 
afeandenfe^ BASIC, however, that optim is 
open to you. You'll need to access the de- 
ments of the array "manually" by determining 
the offset to the item you need; yoii c{?^ 
define the offsets in "standard" variables to 
help systematize things. 

Incidentally, several readers have also asked 
where they can get started learning C or Pascal 
on the llgs. The Byte Works (4700 Irving Blvd. 
nW. Suite 207, Albuquerque, JY.M., 87114. 
505-898-8183, QEnie BYTEWORKS, America 
Online MikeWSO) has been offering on-lirie and 
correspondence courses in C and Pascal fea- 
turing their languages (OKCA/C and 
ORCA/Pascal) on the llgs. The lessons take 
you through the elements of the language up 
to the point where you can start concentrating 
on learning the llgs ToolBox. f^om there, you 
should probably try to acquire as much llgs 
source code as possible (specifically the exam- 
ples.provlded by Apple DTS) and (j'Ssect how it 

I have a lapel bvUon that reads 'Csbn 
down.,.!t's only ones and zeros". The ToolBox 
f$ thm to help; don't let it intimidate 

dBASE III file translation 

Using the PC Transporter I wouW like to 
translate files from dBASE ilh to an AppleWorks 
database file. Can it he done? 

Jeffrey S. Bock 
newMiiy Pai*, CaHf- 
We 've mentioned CiassWa^ 3i9 -a 
method of moiing files between and Appk H 
md an MS-DOS machine, but since the file 
conver^om are actually done on the WSDOS 
machine you eould run the program with the 
FC Trampoitee (converting ttie files in the MS- 
DOS "partiViOifi and then copy the files ow to 
ProDOS. This is faster than using the modem 
transfer method, but would a/so require you to 
con-ect the filetype of the converted files after 
you copy them to the ProDOS side of your 
schizoid computer's world. There is a handy 
freeware utility called FAZ (File Attribute Zap- 
per) that will facilitate assigning the correct 
types. 

The other option would tx to convert the 
dBASE Hl4- data to a text file format suitable to 
read into AppleWorks. You will lose some data 
in the transfer this way that CrossWorks will 
attempt to. convert, such as report 

Pushing tlie envelope 

What effect, would replacing raiy 7 MHz 
Tmswaip QSs presetit 28 MHz ciysM oscilla- 
tor with a 32 MIU one .as shown in Applied F.nij- 
neering's advertisement have? 

Stephen Oant 
Manteca, ^alif. 

We have never looked that closely at the 
advertisement, but... our suspicion is that it 
may (or may not) speed up your system slight- 
ly, if the chip will operate reliably at the higher 
speed. It w&uld ptobsbiy also void: your war- 
ranty. 

There have txen Instructions circulating on 
accelerating the TransV/arp GS by replacing 
the 65816 processor on the card with a faster 
[higiier MHz rating) chip, increasing il}e , speed 



of the crystal oscillator, and (when necessary) 
installing faster static MM to support the 
Speed /ffcre^e. (im of the more; detailed doc- 
umem we t^t sem is mdte,d to Andrew 
iMl of Western Design Center, md $de<^ately 
expiaim the hmrds of tbe "enhancermnf'. 
We havent done (he tnodifksMon, but you 
shouid reaSie goir^ in that it isn't simple. 

The 65816 should operate at one-fourth the 
frequency of the crystal oscillator; that is, for a 
7 MHz 65816, a 28 MHz oscillator is the cor- 
rect value. It might be that the 65816 may 
operate at a slightly higher speed than its rated 
value, but we couldn't presume to second- 
guess Applied Engineering or Western Design 
Center on this. According to Tony Vece at Zip 
Technology (Zip is also working on a llgs accel- 
erator card), the static RAM cache used by the 
llgs accelerators should accept accesses at the 
crystal oscillator's speed (four times the pro- 
cessor speed); the corresponding access rate 
for a 28 MFIz oscillator is once every 35.71 
nanoseconds. That means if you speed up the 
oscillator (and processor} boo much, youH 
need to unsolder 0nd replace m static RAW 
chips with faster versions. 

Dontpyf too much faith in advertising pho- 
tos; we remember the ong/fla/ Zip Chip prrxmo- 
tional flyers where the chip was shownplu^d 
into the MMU socket (rather than the pwEessor 
socket) on a lie motherboard.~DJD 

More orplian help 

1 sold my 11 Plus and purchased a used 
enhanced lie and now 1 need a patch which will 
enable me to use Checkmate's MultiView 
80/160 card with AppleWorl^. I wrote Check- 
mate and they told me they no longer support 
their card. Also, I recently inherited a Qume Let 
terFro 20S printer and am in need of a bidirec- 
tional forms tractor. Qume no longer supports 
t|iat printer so I am on my own for parts„ If afiy- 
iate can help me or put me In t^uch with a 
source I will be forever grateful, 

Richard Washington 
P.O. Box 253 
Tort Union, Va. 23053 

Control Panel shortcut 

Is there any way to disable access (and later 
of course, restore it) to the ligs CDA menu? For 
example, a game that selectively enables a 
TransWarp OS would be thrown off if it was 
manually set. 

John Morrison 
Philadelphia, Penn. 

It's better to tell the user not to alter the 
Cmtrol Panel settings in your documentation 
tim to lock them out of access; let the user 
accept responsibility for how the computer is 
used. The particular feature you don't want 
them to alter is only one of many options the 
Control Panel controls.— DJD 

Hard 6\sk interleaves 

flow can I determine the best interleave for 
my hard disk? Do I have to try all possible com- 
binations? 1 am using a Seagate ST-157Pi. 

Chang Yuh Kang 
Republic of Singapore 

You don't have to try every combination, ttut 
you will have (o try several in order to. "frame' 
the best time. This may vary from drive model 
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to dirfre model as access characteristics 
change. You can, for example, start with the 
hi^i&i poS^t^e interleave setting, reduce it by 
five every time unW you Find the interleaves at 
which performance gets worse, and then try all 
the $&tii^ between the tWQ wh&e l^e 'dipp' 

mse ^i^ss on a S&0(te Sr-277lt, nM ma 
wftftoot fl& naaMarp :G$ aeSwf, aad Ome 
were hi! resuHsfaB MingS ^ ^o^«dSh 

Interkcive IHGS Od IDS Off 

1:1 U.il 17.es 

5:1 13.2S 13.61 

7:1 10.69 18.09 

5:1 13,71 15.66 

U:l 12,51 U.H 

These Hmfngs were accompilsfied Irt the 

same way (move a large file onto a freshly for- 
matted HD and then load it while timing the 
load). 

Here are Tom's timings for an 80 meg ST296n: 

lateilesve IKS On IKS Of f 

1:1 n.2l 18.70 

5:1 14.10 20.C0 

hi 12.12 U.2f 

1:1 li.lt U.!8 

9^1 11.20 urn 
m ii.3t n.36 

11:1 ll.n 16. 65 

You should pick an interleave at or slightly 
above where the timing seems to increase sig- 
nificantly; for example, for the ST2961i wth 



A2'Cenbial 



©Copyright 1990 by 
Amoetiffaf 

Most nghls resBved All piogram (mtishsl AKiatiTi puuc 
ilcinini and ntfl be coped sna AaliiLlec ifMiXds'-^ ha-, jsa groups 
and sgntetit Mhn P'^'iism ffl repiim ariM« horn 

IVSpKlliciMlMNqM. 



Edited by: 



Dennis Doma 



wi!^ hep from: 

Tom WelslMW SMI|! SNpr Dwi Eamsy 

Jcyce Hammond JinNiuir JayJaminss 

Tom ^nderpool Jean WsishHr 

Al-CenltiL-^ Opni..«pplF ihrauSh Januaiy. :91B-M bi»m (lib- 

IsHed monNy 5incE J2tij;,'< ^sas VftrW-M* prices fin US dollars: armai 
celiveiy inciuSoc a -■" «<: . charge) 528 far 1 year: $W tor i years: $78 tor 
3 yua^ All hacn isuss jic 'jjiiertly avalabk! tor S2 each; bound, inrlejud «(■ 
dons qi oyr Ira Ipi* vnliimes iire Si^.a^j e.'ich Vr^kir^ie^ erx3 wnl^ irie j;-.:.--/ 
issue: an iffije* to' ihsprnrvolijTOis irnjluc*^iwitliir>t: Febnjary issye. 

The lull leit ot hcIi issue of A2.Ceiilral Is available on 3S disks, along 
wlh a slgdoh o' ili$ best new public domin and gtwewaiB lll«sand pro- 
grams. fH {64 a y«ar (newsletter and disk omtilnKO. StnglEttisteara tlO. 

Pkstl atne all wrrKponMas to: 

A2-Centrid 

P.O. Box 11250 
Overland Park, Kansas 66207 U.S.A. 

iU-Cnim Is Sdid in an unpnHscud tonral Its jw camenianoe. Mm 
B» emauagad u rntM bactt-up aidtM cqn or eaqMfr^ 
cofte bifiw SM iM wthoul olilrgt. Ibu may to oiv JZCntnC (» 

disHiutron Is Dlheffi, Tin illstribulion IM % IS iSiiR !«' pagi pet copy dds- 
liiu^. 

WAHnANTY AND UttlTATlON OF LIABiLIT'i. I *i-oi\: Ibal moel ot the 
hftimialioi' r /tz-Cnlral u jse'-' :ir:j :.:;r"c:. ; reughdnvel anil mis- 
ttKes are Included Ircir tims tc t^-t; ni^i-ri '> ,.-in;snL!onalty. Uniaiislwd 
BUbarmefS n^y caiK«l th*ir SLiKCiipi^or .u any iime and receive a lull 
reluiK) ot Ihair last subscnplun paymenl The uhllllad poilian ol any fni 
ajbschplion will be reiurxted even to salitfied sitectibers upon request. 
MY UAHLITY FOB ERRORS OMISSIONS IS UMITED TO THIS 
PLBUCATIQN^ PURCHASE PRICE. In flo OM M I er iny mMwIois 
b« IMi.ler iny kicidanial or cohjequental dimagaa. nor br dam- 
^es in neesa of Itie lees paid by a subgalber. 
ISSN 0885-4017 SEnlanalfeAaCENTRAL 

Printed in ttieUSJ*. I*c «W69-6S07 



the TransWarp GS "on' Tom picl\ed the 9:1 
interleave. However (as we've said), be aware 
that your speciric conftguration and usage 
determine the .tiest f/m/ngs; the interleave that 
facilitates the fastest time for writing a 5 
me^^e rUe front BASIC mm not tx the one 

database/He 

QiSBOtti'S mw S&t iMUies i01iKSm m 
c^rtfon to 'Moern' i^fxaa wider AaDCtS B-mt^ 
Ok imt fffteii^ve to use ifoa tBs^ $tM 
m verify tte result mMyoarom Umlas^ how- 
ever.—OJD 

MoreonDMASC^I 

As a ffi]lc)W DMA SCSI card owner, I must 
reply to Udo Huth's letter ('Don't hang up', June 
1990). I have a Jasmine 40 megabyte drive 
attactied to the DMA card in slot 7 and I origi- 
nally thoiiflht the ssstem was hanging if the 
drive was not switched on. tn practice. It "times 
out' after 20-25 seconds and contiiiues fiom 
the 3.5 disK. 

I have some comparative times for the old 
and new cards. My ligs system has .5.25 
megabytes of memory, a TranslVarp G5, and my 
Jasmine's seek time is 26 milliseconds. The 
interleave is 1:1, which is better than 2:1 and 
the (unluiown) original value, but I'm not sure if 
it's the bKtl Both times use the new drivers 
(Which are sli^Uy faster for the oid card as 
wdl!). A feBcfiiating thing is that the times often 
Vdty fsp and down by several seconds under 
otherwise fixed condttions. I^ie Smes listed ate 
average tlmingsi 
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l^e sound Ales were what convinced me 
buy the card. 1 can through a directory oit 
sounds In (almost^ restf Hme-- very impressive. 
The simple fact is that the card speeds up the 
h-ansfer rate. If the drive spends its time seek- 
ing, as during a boot or loariintj a segmented 
file like AppleWorks OS, then the speed-up is 
minor. Give it a large llle to load and you are 
talking 'greased lightening'. I am hoping Claris 
will provide an installation option to allow "true' 
preloading of AppleWorks QS so that people 
with enough memory and a DMA card will be up 
and running (all modules) in around 12 sec- 
ondsl 

Peter Watson 
BoxnUirkutb.Vic 

More power to you 

I have a 512K lIgs and have noticed a sl^ 
problem. My system is configured as folio*©: 

Basic512Kllgs 
Apple RGB Monitor 
Kensington System Saver 
CiS-RAPI Plus with I megabyte 
Applied Engineering Miihik2400 
HyperStudio digitizer 



CMS 20 megal^ hanl disk 
Apple 3.5 
Apple UnlDisk5.5 
Apfde S.2S 

I didnt notice ilds piioUem untii t dai^ 
cheuned the UniDM fioin the Apple 3.5. Howev- 
er, when I boot the system from the haitl disfc 

the re ad /write light on the UniDisk pulses! I 
tooK the UniDisk off of the system and then 
noticed that the 5.25 read/write light did Bic 
same thing but wasn't as noticeable. 

I then put the UniDisk back in the chain and 
noticed that the UniDisk and 5.25 drive woe 
tXJth pulsing at the same timcl 

I stripped the whole system down to a basic 
machine with only the Apple ^.5 drive connect- 
ed and tried all versions of OS/OS (v2.0 through 
5.0.2) and found thai I had an audible pulse 
tone through the speaker, After disconnecting 
the speaker t noticed I could still hear an elec- 
trical click in the power supply. 1 took it to our 
local Apple "dealer" and he confirmed tliat the 
power ^pply is bad. 

flow my question: the Apple supply Is $135 
as opposed to the Applied Engineering supply 
which is $99. Which would you consider, forget- 
ting cost difference, as tietter for the iigs s^is- 
tem? 

Walter Honhor 
flephzlbsh, €^ 
This sounds ifte a n^btnme. Lefs t^tmx a 

few steps. 

Mi* *e patflMt**£ with the UniDisk XS 
ittstaBed is nonnaf. Some lIgs programs like 
the Finder have to mortffor the drive to see if a 
disk has (wen changed: the UniDisk takes Otis 
'polling' rather hard. We've got Ilgs systems 
here that have survived this for years. 

Second, the click in the speaker may be nor- 
mal. My ROM 01 machine at home does this 
(with only an Apple 5.5 and 5.25 attached) 
when I turn the sound level up. It apparently is 
some son of ao&talk nsaching Ok sound ct- 
cuHiy, 

Thkd, tfie 'dick' In the pOHer supi^ may 
M may not be normal. The supply Is a switch- 
it^ type that emits a high-pitched whine in 
some people's hearing range (t guess I'm one 
of the 'foitunate' ones). As the sufpfy tias to 
'strm' a Mia send the po^pufse to the 
^ jiQ^ i cm hem ^Ste ft&iueiKy of Ote 
MMne change, il^ ^em has dcme ^Is eter 
^nceiioi0ilit. 

ifym mm had m dtHr jm^^^sas with (he 
system Offlef ffian ffie 'cffcff tim tfie ptm^r 
supply and speaker while the drives are poSed 
(the pulsing of the drive tights is perfectly /for- 
mal) you may want to check a little more into 
how the dealer determined the supply is 'barT; 
that is, did he use some sort of di^ostic 
equipment or just recommend replacing the 
supply as a cure for the 'problems' you've 
seen. If the latter I'd suggest asking for a guar- 
antee that the new supply will eliminate the 
problems. If he's willing to do it. paying the 
extra dollars may be worth it. If not, and you 
determine the supply is the problem, then it 
may be a toss-up. fly feeling is that it is worth 
paying a little more for the Apple logo all other 
things being equal; for one thing, it eliminates 
my contention with the deafer about my as- 
tern coaflauralion. OUias are quite w^ome to 
i^sa^ee.-^t> 



